home *** CD-ROM | disk | FTP | other *** search
/ Windows Expert / Windows Expert.iso / database / winsql11.zip / README.DOC < prev   
Text File  |  1991-09-26  |  15KB  |  332 lines
  1.  
  2.           General Information                                Page 1 of 6
  3.  
  4.  
  5.                               Orion SQL For Windows
  6.  
  7.                            Release 1.1 - September 1991
  8.  
  9.  
  10.                                GENERAL INFORMATION
  11.  
  12.  
  13.                      Copyright (c) 1991 by Stellar Industries
  14.                                All Rights Reserved
  15.  
  16.  
  17.                              Release 1.1 Enhancements
  18.  
  19.  
  20.           Orion SQL For Windows Release 1.1 adds several new features:
  21.  
  22.           ** INDEX CAPABILITY
  23.  
  24.                Adding indices to tables greatly enhances performance.  A
  25.                simple SELECT which extracts 5 records from a table of
  26.                3000 takes 10.6 seconds without an index.  The same
  27.                SELECT statement takes only 0.6 seconds when there is an
  28.                index on the table.
  29.  
  30.                While indices may be created at any time, we recommend
  31.                that you create indices immediately after you create
  32.                their base tables, otherwise CREATE INDEX has to read and
  33.                rewrite all data which is already in the table.
  34.  
  35.                The syntax for creating an index is: "CREATE INDEX
  36.                <IndexName> ON <TableName> (<column name>, <column name>,
  37.                ...)"
  38.  
  39.                The syntax for dropping an index is: "DROP INDEX
  40.                <IndexName> ON <TableName>"
  41.  
  42.           ** GENERAL PERFORMANCE IMPROVEMENT
  43.  
  44.                Even without using indices, Orion SQL For Windows Release
  45.                1.1 has significant performance improvements over Release
  46.                1.0 (minimum 3 to 6 fold) as evidenced by the timings
  47.                below.  These queries are available to you in the
  48.                EXAMPLES.ZIP file.
  49.  
  50.                   +--------------------------------------------+
  51.                   | release:           |    1.0    |    1.1    |
  52.                   |--------------------+-----------+-----------|
  53.                   | QUERY15.SQL        |  6.0 sec. |  1.4 sec. |
  54.                   |--------------------+-----------+-----------|
  55.                   | QUERY16.SQL        |  5.1 sec. |  1.9 sec. |
  56.                   +--------------------------------------------+
  57.               (80386 33MHz, 17 msec IDE disk, HYPERDISK disk cache)
  58.           General Information                                Page 2 of 6
  59.  
  60.  
  61.           ** OTHER ENHANCEMENTS
  62.  
  63.           o    As the transaction journal grows in size it may now
  64.                be checkpointed: all committed transactions are
  65.                backed up to any media you choose leaving a nearly
  66.                empty journal (only available on the registered
  67.                version).
  68.  
  69.           o    A new data type: "VARCHAR <data type>" for the
  70.                CREATE TABLE statement.
  71.  
  72.           o    The Registration Reminder is removed from Query
  73.                Editor.
  74.  
  75.  
  76.  
  77.                      Unpacking and Installation Instructions
  78.  
  79.  
  80.           Orion SQL For Windows is provided as a single compressed file.
  81.           (WINSQL11.ZIP).  The contents of WINSQL11.ZIP are defined in
  82.           the included PACKING.LST file.
  83.  
  84.           Efficient operation of SQL For Windows requires that you use a
  85.           disk cache manager (such as MicroSoft's SMARTDRV.SYS).  For
  86.           superior performance use a disk cache manager which also
  87.           caches disk writes, such as Norton Disk Cache (available with
  88.           Norton Utilities) or Hyperdisk Disk Accelerator (available as
  89.           shareware from HyperWare*).  We at Stellar Industries
  90.           recommend Hyperdisk Disk Accelerator with which we observe a
  91.           three to six fold performance enhancement verses SMARTDRV.SYS.
  92.           Hyperdisk is available on many BBS's as HYDK421.ZIP.
  93.           Documentation for these disk cache managers should be
  94.           carefully reviewed.  Utilizing SMARTDRV.SYS instead of
  95.           HyperDisk, the above timings become:
  96.  
  97.                   +--------------------------------------------+
  98.                   | release:           |    1.0    |    1.1    |
  99.                   |--------------------+-----------+-----------|
  100.                   | QUERY15.SQL        | 20.0 sec. |  4.7 sec. |
  101.                   |--------------------+-----------+-----------|
  102.                   | QUERY16.SQL        | 22.0 sec. |  8.4 sec. |
  103.                   +--------------------------------------------+
  104.  
  105.           The importance of a good disk cache manager and thoughtful
  106.           database design including the use of indices (where
  107.           appropriate) cannot be over emphasized.
  108.  
  109.           In order to properly install SQL For Windows on your computer
  110.           you will need to perform the following steps:
  111.           ____________________
  112.  
  113.           *  HyperWare, RR#1 Box 91, Pall Mall, TN 38577; voice: (615)
  114.           864-6868; BBS: 8N1 (HST, V.32, V.22bis): (615) 864-6871
  115.           General Information                                Page 3 of 6
  116.  
  117.  
  118.           1)   Move DBA.EXE, DBA.HLP, QE.EXE and QE.HLP to the directory
  119.                in which you keep windows programs.  This is usually the
  120.                'c:\windows' directory.
  121.  
  122.           2)   Make two new directories.  One will be for the Orion
  123.                Database Administrator's files (we recommend naming it
  124.                'database'), the other will be for your queries and data
  125.                (we recommend naming it 'data').  You can use the MS-DOS
  126.                'mkdir' command to do this.
  127.  
  128.           3)   Unpack EXAMPLES.ZIP (contained within WINSQL11.ZIP).
  129.                This file contains both sample queries and an import file
  130.                to load some sample data into the database.  We recommend
  131.                putting these files in your 'data' directory.
  132.  
  133.           4)   Use your favorite editor (NOTEPAD.EXE will suffice) to
  134.                modify the windows initialization file WIN.INI.  This
  135.                file can usually be found in the 'c:\windows' directory.
  136.                Add the following lines:
  137.  
  138.                     [OrionDba]
  139.                     AutoStart=0
  140.                     DatabasePath=c:\database
  141.                     DataFilePath=c:\data
  142.                     FileNameDatabaseDump=c:\temp\orion.dmp
  143.                     Suspend=0
  144.  
  145.                     [OrionQe]
  146.                     Acknowledge=1
  147.                     AutoStart=0
  148.                     DataFilePath=c:\data
  149.                     OpenNew=0
  150.                     UserName=SYSTEM
  151.                     UserPassword=ORION
  152.                     WarnOnClose=1
  153.  
  154.                As DBA.EXE and QE.EXE automatically add some of these
  155.                lines if they do not already exist, be sure you are not
  156.                adding duplicate entries.  If you edit WIN.INI before
  157.                running DBA.EXE or QE.EXE you don't have to worry.
  158.  
  159.                These entries have the following meanings:
  160.  
  161.                [OrionDba]          Identifies a block of entries as
  162.                                    belonging to the Orion Database
  163.                                    Administrator.
  164.  
  165.                AutoStart           Set to '0' or '1'. When set to '1'
  166.                                    causes the Orion Database
  167.                                    Administrator to automatically start
  168.                                    the database as soon as you start the
  169.                                    program.
  170.           General Information                                Page 4 of 6
  171.  
  172.  
  173.                DatabasePath        Set to the path you want the database
  174.                                    files to reside in.  Make sure to
  175.                                    create this directory before starting
  176.                                    the Orion Database Administrator.  We
  177.                                    recommend naming it 'database'.
  178.  
  179.                DatafilePath        Set to the path you want to use as
  180.                                    the default for import and export
  181.                                    operations.  We recommend naming it
  182.                                    'data'.
  183.  
  184.                FileNameDatabaseDump       Set to the full file name of
  185.                                    the file you want the Orion Database
  186.                                    Administrator to use for the 'dump'
  187.                                    operation.
  188.  
  189.                Suspend             Set to '0'.
  190.  
  191.                [OrionQe]           Identifies a block of entries as
  192.                                    belonging to the Orion Query Editor.
  193.  
  194.                Acknowledge         Set to '0' or '1'. When set to '1'
  195.                                    causes the Orion Query Editor to
  196.                                    display an informational dialog box
  197.                                    every time a query completes.
  198.  
  199.                AutoStart           Set to '0' or '1'. When set to '1'
  200.                                    causes the Orion Query Editor to
  201.                                    automatically start the Orion
  202.                                    Database Administrator if it is not
  203.                                    already running.
  204.  
  205.                DataFilePath        Set to the path you want to use as
  206.                                    the default for file operations.  We
  207.                                    recommend naming it 'data'.
  208.  
  209.                OpenNew             Set to '0' or '1'. When set to '1'
  210.                                    causes the Orion Query Editor to
  211.                                    automatically create a new 'pad' when
  212.                                    the Query Editor first starts.
  213.  
  214.                UserName            Set to 'SYSTEM'.  This identifies the
  215.                                    default user name.
  216.  
  217.                UserPassword        Set to 'ORION'.  This identifies the
  218.                                    default user password.
  219.  
  220.                WarnOnClose         Set to '0' or '1'. When set to '1'
  221.                                    causes the Orion Query Editor to
  222.                                    prompt the user for a file name
  223.                                    before closing a pad which contains
  224.                                    text not yet saved to disk.
  225.           General Information                                Page 5 of 6
  226.  
  227.  
  228.                SQL For Windows also relies upon the international date
  229.                and time settings.  The Windows defaults are fine and you
  230.                can leave them alone.  If you've changed them, don't
  231.                worry, time stamps are saved in binary and not converted
  232.                to international format until used for output.  If you're
  233.                interested, we recommend the following settings:
  234.  
  235.                     [intl]
  236.                     iDate=0
  237.                     iTime=0
  238.                     s1159=AM
  239.                     s2359=PM
  240.  
  241.                International date and time settings are most easily
  242.                changed via Microsoft's Windows Control Panel.  Select
  243.                the "International" icon then click on either "date" or
  244.                "time".
  245.  
  246.           5)   Use Microsoft's Program Manager to create a new program
  247.                group:
  248.  
  249.                a) select 'File', 'New'
  250.  
  251.                b) select 'Program Group', 'OK'
  252.  
  253.                c) Enter description: 'Orion', group file: 'ORION'
  254.  
  255.                d) select 'OK'
  256.  
  257.           6)   Use Microsoft's Program Manager to create two new program
  258.                items:
  259.  
  260.                a) select 'File', 'New'
  261.  
  262.                b) select Program Item, 'OK'
  263.  
  264.                c) Enter description: 'Dba', command line: 'DBA.EXE'
  265.  
  266.                d) select 'OK'
  267.  
  268.                e) select 'File', 'New'
  269.  
  270.                f) select Program Item, 'OK'
  271.  
  272.                g) Enter description: 'Qe', command line: 'QE.EXE'
  273.  
  274.                h) select 'OK'
  275.  
  276.           7)   Start the Orion Database Administrator by clicking on the
  277.                'Dba' Icon in the Microsoft Program Manager.  When the
  278.                Orion Database Administrator's window appears select
  279.                'Toolbox' from its menu.  Select the 'Install' entry,
  280.                this will install the database in the directory
  281.                identified by the 'DatabasePath' setting described above.
  282.           General Information                                Page 6 of 6
  283.  
  284.  
  285.           8)   You may now exit ('Exit' is in the 'File' menu) the Orion
  286.                Database Administrator.  SQL For Windows is completely
  287.                installed.
  288.  
  289.                                      Examples
  290.  
  291.  
  292.           You will probably want to run our examples to familiarize
  293.           yourself with the operation of SQL For Windows.
  294.  
  295.           1)   Start the Orion Database Administrator by clicking on the
  296.                'Dba' Icon in the Microsoft Program Manager.  When the
  297.                Orion Database Administrator's window appears select
  298.                'Control' from its menu.  Select the 'Start' entry, this
  299.                will start the database.
  300.  
  301.           2)   Start the Orion Query Editor by clicking on the 'Qe' icon
  302.                in the Microsoft Program Manager.  When the Orion Query
  303.                Editor's window appears select 'File' from its menu.  Now
  304.                select the 'Open' entry and open the file CREATE.SQL.
  305.                This is one of the files contained in EXAMPLES.ZIP.  When
  306.                its text appears in a pad select the menu commands
  307.                'Database', 'Execute' (or hit control/x).  This query
  308.                creates the tables of the example database.
  309.  
  310.           3)   Now go to the Orion Database Administrator and select the
  311.                menu commands 'File', 'Import'.  Select the file
  312.                EXAMPLE.DAT.  This is one of the files contained in
  313.                EXAMPLES.ZIP.  The 'Import' loads the data in EXAMPLE.DAT
  314.                into the tables you created with CREATE.SQL.
  315.  
  316.           4)   You can now execute any of the sample queries contained
  317.                in EXAMPLES.ZIP.  Go to the Orion Query Editor, open a
  318.                file (for example QUERY01.SQL) and execute it.  Files
  319.                which contain select statements will cause the Orion
  320.                Query Editor to open a new pad and place the data as text
  321.                into the new pad.  You may then edit the data and/or save
  322.                it to a file using the 'File', 'Save As' commands.
  323.  
  324.           5)   To remove the sample data from the database just execute
  325.                the SQL 'drop table' statements in the DROP.SQL file.
  326.  
  327.           6)   You are now ready to write your own SQL statements and
  328.                create your own database.
  329.  
  330.           Stellar Industries:      (714) 861-7885
  331.                                    3335 S. Falcon Ridge Road
  332.                                    Diamond Bar, CA  91765